WorldClient Pro © 1999-2000 Alt-N Technologies. All Rights Reserved.
Directories & Files

The following is a list and overview of the primary directories used by WorldClient Pro, and the files that each directory contains.

\WorldClient\
Besides WorldClient Pro's main application files, the base directory contains several files that you may need to work with:

• Relnotes.txt - This file lists all additions, changes, and fixes to the current version of WorldClient. It will also contain any special considerations that it is important for you to know. You should always look over this file after installation to make sure that you are aware of any important changes.

• WorldClient.pdf - This is WorldClient's user manual. It is in Adobe Acrobat format and requires the Adobe Acrobat Reader to view or print. If you do not have this utility then you can obtain it free of charge from www.adobe.com. All information contained in the manual is also available in WorldClient's online help systems.

• WorldClient.ini - All non domain or user-specific settings for WorldClient Pro and the Administration Utility are stored in WorldClient.ini.

• Domains.ini - Contains all of WorldClient's domain settings-both default and domain-specific settings (when hosting multiple domains). It also contains the default settings and domain-specific default settings for new users. User specific settings are found in the User.ini file located in each user's subdirectory. The name of this subdirectory is the same as the user's sign-in name, and is located in the \Users\ subdirectory. Last, domains.ini contains the default and domain-specific user overrides. These settings will take precedence over user settings specified in the other user sections and the user.ini files.

• AddrLookup.ini - This file contains a section for each unique LDAP server that you want to allow your users to query using the Address Lookup feature reached from the Compose page. An LDAP search is done based on the settings that you specify in this file.

• AddrBook.txt - This is the file used for building WorldClient Pro's Global Address Book. Personal Address Book entries are built from the AddrBook.txt file that is located in each user's personal subdirectory.

• Dictionary.txt - Contains administrator added words that the spell checker should not treat as misspelled. This system-wide dictionary file will apply to all users. Users also have their own personal dictionary files located in their individual directory. A user's personal "Dictionary.txt" file will not apply to anyone else.

• Footer.txt - This is an optional file. Whenever this file is placed in WorldClient Pro's base directory the contents of the file will be appended to composed messages when they are sent. This is useful for placing a disclaimer or comment at the bottom of all email messages composed by your users.

• Welcome.msg - This is the welcome message that will be sent to new users if the SendWelcomeMessage key is set to Yes. This key is located in the [AccountCreation] section of WorldClient.ini. This is a plain text file that can be edited with any text editor. See page 23 for more information on the welcome message.

\Admin-CGI\
This subdirectory is where you should store CGI's that you wish to use with the Remote Administration interface.

\HTML\
The HTML subdirectory contains a number of important subdirectories and files used by WorldClient Pro:

Theme Subdirectories
For each of WorldClient's Themes (see \Templates\) there is a separate subdirectory contained in the \HTML\ subdirectory. Each of these subdirectories will have the same name as the WorldClient Theme they represent and will contain:

• Image files - All image files that are referred to by the Theme.

• *.css - The Cascading Style Sheet files referred to by the Theme's templates. This corresponds to the User's "Style" selection (see \Templates\).

• *.js - These are the files containing the JavaScript functions included in the Template files (see \Templates\).

Admin Subdirectory
This directory is similar to the Theme subdirectories. It contains the image and style files referenced by WorldClient Pro's Remote Administration interface. It also contains a \help\ subdirectory that contains the Admin's help system.

Help Subdirectory
This directory contains WorldClient's user help system. This is the client-side help system used for explaining all client functions.

Additional Files
Any non-template HTML files that you have created and wish to incorporate into your WorldClient Pro site.

• Image files - All image files that are referred to by WorldClient Pro's Templates (see \Templates\).

• *.css - The Cascading Style Sheet files that can be included in your Templates. This corresponds to the User's "Style" selection (see \Templates\).

• Globals.js - This is a file of all JavaScript functions included in every Template file except Logon.html (see \Templates\).

• Additional Files - Any non-template HTML files that you have created and wish to incorporate into your WorldClient Pro site.

In addition, this directory contains the "Help" and "Help-Admin" folders, which contain the help systems for the email client and for WorldClient Pro administration.

\Logs\
The Logs subdirectory contains five log files that WorldClient Pro maintains:

• http.log - This log is a CLF (Common Log Format) compliant http request log. You can parse this log with any popular web statistics software to see access statistics to your WorldClient Pro site. In the future, we will also support ELF (Extended Log Format), which includes the agent and referrer information.

• http-admin.log - This log file is the same as the http.log except that it is used for the Remote Administration Server.

• WDaemon.log - This file contains low-level, human readable logging of messages from the WorldClient Pro web server.

• WDaemon-admin.log - This is the same as the WDaemon.log except that it is for Remote Administration.

• WorldClient.log - This file contains detailed logging of all WorldClient Pro activity.

\Users\
The Users subdirectory contains a separate directory for each WorldClient Pro user. The name of this directory is the same as the user's sign-in name. Each user's subdirectory contains:

• User's mail folders - These contain the user's email messages.

• AddrBook.txt - This is the user's personal address book file.

• Dictionary.txt - Contains user added words that the spell checker should not treat as misspelled.

• Signature.txt - Stores the signatures that the user has created for each of his mailboxes.

• Messages.idx - Information about the user's messages is stored in this file (e.g. filenames, To:, From:, Subject:, and so forth).

• *.uid - These files contain the POP3 unique identifiers for the messages on each mail server from which WorldClient is collecting mail for the user.

• User.ini - This file contains the user's personalized settings.

\Util\
This directory contains several utilities that you may wish to use with WorldClient Pro:

• ImportNT.exe - Used for importing your Windows NT user base into WorldClient Pro.

• ImportTXT.exe - Used for creating WorldClient Pro accounts from a text file.

• ModifyUsers.exe - This utility is used for changing any setting in your WorldClient user.ini files. It makes it possible to add, remove, or edit the value of keys across all of these files rather than having to edit them one at a time.

• Migrate.exe - During installation, this utility converts any preexisting WorldClient user accounts to WorldClient 2.1 format.

• WCWatch.exe - WCWatch is a tray applet that can be distributed to your users. It runs in the background and checks for new mail by querying the WorldClient server directly. This eliminates the need to keep a browser open. It will check for new mail and inform you of unread messages in your mail folders. It will also launch your browser and automatically log you into WorldClient when you are ready to read your mail. See WCWatch.txt in the \Util\ directory for more information.

\Templates\

All of the HTML files used by the WorldClient Pro parsing engine are stored in the Templates subdirectory. These HTML files are read in and all variables (denoted by <$varname$>) are replaced by WorldClient Pro on the fly and then sent to the browser. There can be any number of different "Themes" directories in the Templates subdirectory. These are available for the users to select between based upon their preference or browser. WorldClient Pro ships with two themes: Standard-WorldClient's original Theme which utilizes frames with JavaScript, and Globe-the latest and most advanced Theme containing many new features, controls, and images. This directory is also where you will place any new Themes that you create or acquire from some other source.

For more information on Templates see: Themes.

For instructions on creating custom Themes see: Creating a New Theme.